"API-1019..." when trying to open a project in the Modern UX

Products

Clarity PPM On Premise Clarity PPM SaaS

Issue/Introduction

Every time you try to open a project in the New User Experience (UX) in our Clarity environment you get the following error:

API-1019: Could not process the request due to internal error.

Environment

CentOS
Redhat

Resolution

Here are the possible causes:

1.The API-1019 error code at first, can mean you are attempting to use a Studio attribute in the New User Experience that does not have a valid REST API alias name.

2. On non-Windows environments, the following packages may not be installed:

libXext-1.3.3-3.el7.x86_64
libXtst-1.2.3-1.el7.x86_64
libXrender-0.9.10-1.el7.x86_64

3. In a related symptom, the Status Reports cannot be previewed nor printed. Status reports do not use fonts, but the third party pd4ml library.

Going to Modern UX > Project > Status > Preview, the following error appears:
API-1019 : Could not process the error due to internal error

In reviewing the APP log:

ERROR 2021-09-21 18:35:40,396 [https-jsse-nio2-8443-exec-268] ppm.rest (clarity:user:session:PPM_REST_API) Exception processing request for resource [statusReportPublisher], query string [/private/statusReportPublisher]
java.lang.InternalError: java.lang.reflect.InvocationTargetException
at java.desktop/sun.font.FontManagerFactory$1.run(FontManagerFactory.java:86)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.desktop/sun.font.FontManagerFactory.getInstance(FontManagerFactory.java:74)
at java.desktop/sun.font.SunFontManager.getInstance(SunFontManager.java:249)
at java.desktop/sun.font.FontDesignMetrics.getMetrics(FontDesignMetrics.java:265)
at java.desktop/sun.font.FontDesignMetrics.getMetrics(FontDesignMetrics.java:251)
at java.desktop/sun.awt.SunToolkit.getFontMetrics(SunToolkit.java:582)
at java.desktop/sun.awt.HeadlessToolkit.getFontMetrics(HeadlessToolkit.java:330)
at org.zefer.font.c.super(Unknown Source)
at org.zefer.font.c.<init>(Unknown Source)
at org.zefer.cache.ResourceCache.getFontMetrics(Unknown Source)
at org.zefer.html.doc.q.Object(Unknown Source)
at org.zefer.html.doc.q.Ö00000(Unknown Source)
at org.zefer.html.doc.w.<init>(Unknown Source)
at org.zefer.html.doc.PD4MLHtmlParser.buildDocument(Unknown Source)
at org.zefer.pd4ml.PD4ML.o00000(Unknown Source)
at org.zefer.pd4ml.PD4ML.render(Unknown Source)
at com.niku.union.utility.PDFGenerator.create(PDFGenerator.java:55)
at com.ca.clarity.projmgr.rest.function.StatusReportPublisherFunctionResource.create(StatusReportPublisherFunctionResource.java:97)

Install the required fonts.

Additional Information

Tip: The API-1019 error code can also mean you are attempting to use a Studio attribute in the New User Experience that does not have a valid REST API alias name.

Make sure attribute has a valid API Attribute ID in Classic UX (Administration --> Studio --> Object --> Attributes ) This is the attribute id used in the REST API.
Set this to make the attribute available via the REST API.